1.2 Scheduler - IOCS Interface 

I/O Initiation 

A task issues an SVC to enter IOCS. I/O services for pretransfer processing are then 
executed at the software priority level of the requesting task. Once the I/O request has 
been initiated (or queued for initiation), an H.EXEC entry point is called to report the 
event to the CPU and sv/apping scheduler: 

Entry Point . Event 

H.EXEC,1 Interactive input starting 

H.EXEC,2 Terminal output starting 

H.EXEC,3 Wait I/O starting 

H.EXEC,4 No-wait I/O starting 

Wait I/O Post Processing 

A return will be made to IOCS from H.EXEC,!, 2, or 3 only upon completion of the I/O 
request. Post transfer processing may then occur at the software priority level of the 
requesting task. 

No-Wait I/O Post Processing 

A return from H.EXEC,^ will be made immediately after recording the no-wait I/O 
event. Since IOCS will also make an immediate return to the user task, no-wait I/O post 
transfer processing will occur as a task interrupt service. 

No-Wait I/O Completion Task Interrupt Service 

When the I/O handler interrupt service routine fields a completion interrupt for a no-wait 
I/O request, it will call the executive subroutine S.EXEC4 to report the event. The I/O 
queue entry associated with the call will be linked to the task interrupt list in the DQE of 
the task which made the I/O request. When the scheduler attempts to dispatch control to 
the task, it will discover that a task interrupt is outstanding. It should be noted that task 
interrupts are inhibited during execution of any system service on behalf of a task. It 
should also be noted that no task interrupt will be honored while a higher priority task 
interrupt is active. When the task interrupt is honored, control will be transferred to the 
IOCS routine specified in the Preemptive System Service Header of the I/O queue 
entry. Post transfer processing may then occur at the software priority level of the 
requesting task. When post processing of the no-wait I/O request is complete, the task 
interrupt service may be exited by a call to S.EXEC6 or H .EXEC,12. 

No- Wait I/O Restrictions for System Services 

Post transfer processing for a no-wait I/O request is processed as a task interrupt. Task 
interrupts are not honored while the task is executing in a system service (PC .LE. TSA 
address). An exception to this rule is made for a task that is in a wait-for-any-no-wait- 
I/O-completion state. A task interrupt generated by the completion of no-wait I/O will 
be honored if the task is in the wait-for-any-no-wait-I/O-completion state. A system 
service desiring to do no-wait I/O may issue a series of no-wait calls followed by a wait- 
for-any-call. Care should be exercised to insure that all outstanding calls are completed 
as appropriate. 
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Scheduler - IOCS Interface - IOCS No- Wait I/O Post Processing Overview 
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Scheduler - IOCS Interface - IOCS Post Processing Procedure 
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1.3 I/O Overview From User Request to I/O Complete 
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name is the name of a system module 

num is an entry point number (1,2,3,...) within the system module 

1.12.3 M.CLSE 

This macro marks a file closed to subsequent service. An end-of-file mark can. be 
written and a rewind can be performed. 

Calling Sequence: 

M.CLSE addr,[EOF] , [REW] 

addr is the FCB address 

EOF specifies an end-of-file mark is to be written 

REW specifies the file is to be rewound 

1.12.4 M.DFCB 

This macro creates a File Control Block (FCB) and sets the appropriate parameters and 
specifications common to I/O requests which will be issued for the file. 

Calling Sequence: 

M.DFCB label, ifc , [count], [addrl], [addr2], [addr3], 

[NWr], [NER], [DFI], 

[NST], [RAN3,rASCl TLIDRI flNT] fEVNl ,[5561 

LbinJ ,LnldJ,LpckJ ,loddJ ,L8ooJ 

label is the ASCII character string to be used as the symbolic label for the address of 
the FCB 

Ifc is the 1-3 character ASCII string to be used as the logical file code in the FCB 

count is the. transfer count (bytes) ii '5- /^ '^ 

addrl is the data transfer address 

addrZ is the error return address 

addr3 is the random access address expressed as the hexadecimal block number (zero 
origin) relative to the base of the random access file 
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NWT is the the no-wait I/O specification indicator 

NER is the inhibit peripheral error processing indicator 

DFI is the inhibit data formatting indicator 

NST is the inhibit status testing indicator 

RAN is the random access mode indicator 

ASC or BIN is the forced ASCII or forced binary mode specification, respectively, for 
read operations performed when the file code for this file is assigned to a 
card reader 

LDR or NLD is the skip leader or do not skip leader specification, respectively, when 
the file code for this file is assigned to a paper tape reader/punch device 

INT or PCK is the interchange or packed mode specification, respectively, when the 
file code for this file is assigned to a magnetic tape device 

EVN or ODD is the even or odd parity specification, respectively, when the file code 
for this file is assigned to a magnetic tape device 

556 or 800 is the 556 or 800 bpi tape density specification, respectively, when the 
file code for this file is assigned to a magnetic tape device 

1.12,5 M-DTCOi: 

This macro creates an expanded File Control Block (FCB) and sets the appropriate 
parameters and specifications common to I/O requests which will be issued for the file. 

Calling Sequence: 

M.DFCBE label,lfc , [count], [addrl], [addrZ], Caddr3], [NWT], [NER], [DFI], 

[NST], [RAN],rASC'l rLDRl flNTl rEVN] [5561 

LbinJ ,LnldJ,LpckJ ,LoddJ , LsooJ , 

[addrA] , [addr5] 

label is the ASCII character string to be used as the symbolic label for the 

address of the FCB 

ifc is the 1-3 character ASCII string to be used as the logical file code in the 

FCB 

count is the transfer count in bytes 
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rcLjs, 



i6 



K6 



i^r(^ 









a 



Jr oy^ 



UP^^ 



1.12.7 MJ^-CBEXP 



This macro defines a^ File Contrpjr^lock (FCB) to be used for an Execute Channel 
Program request. 

Calling Sequence: 

M.FCBEXP label,lfc [, [cpaddr], [tout], [PCP], [NWI], [NST], [ssize], [sbuffer], 
-; — =- [iTowaitJ [nowaiterror], [waiterror], [psize], [ppciadr] 

label is the ASCII string to use as the symbolic label for the address of the 

^-— - FCB 

Ifc is the logical file code, word 0, bits 8-31 of the FCB 

cpaddr the logical address of the channel program to be executed 

tout a timeout value specified in seconds 

PCP specifies physical channel program 

NWI specifies no-wait I/O request 

NST specifies status checking not requested 

ssize the size of the user specified sense buffer 

sbuffer the address of the user specified sense buffer 

nowait normal no-wait end action return address 

nowaiterror no-wait end action error return address 

waiterror wait end action error return address 

psize size of PPCI status buffer to use 

ppciaddr PPCI end action address 

1.12.8 h4FWRD 

This macro advances the current address of a blocked file by the number of file or record 
marks specified. 

Calling Sequence: 

M.FWRD addr, [R] [,num] 



addr 



is the FCB address 
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2.7 Controller Definition Table (CDT) 

The Controller Definition Table (CDT) is a system resident structure used to identify 
information required by handlers arid the I/O processor for a specific controller. The 
CDT is built by the SYSGEN process, one for each controller configured on the system. 
The CDT identifies devices (UDTs) associajted with the controller, the handler address 
associated with the controller, and defines (Jther pertinent controller information. 



Word 




— 8 



b: 

23 



7 8 



15 16 



23 24 



31 



String forward address (CDT.FIOQ) 



String backward address (CDT.BIO(i) 



Link priority 
(CDTJLPRI) 
See Note 1^ 



Number of 
entries in list 
(CDT.IOCT) ^ 
See Note 2 



CDT index (CDT.INDX) 



Number units 
on controller 
(CDT.NUOC) 



Program number 
if reserved . 
(CDT.PNRC) 



Flags 

(CDT.FUGS) 
See Note 4 



Number requests 

outstanding 

(CDT.IORO) 



Class 

(CDT.CLAS) 
See Nofce 3 



Device type 

code 

(CDT.DTC) 



^^i 



Channel 

number 

(CDT.CHAN) 



Reserved 




Interrupt 
priority level 
(CDT.IPL) 



Subaddress 
of first device 
(CDT.SUBA) 



Interrupt handler address (CDT.SIHA) or controller 
information block (CDT.CIF) 



I/O status 
(CDT.IOST) 
See Note 5 



UDT address of first device on controller 
(CDT.UDTA) 



TI address (CDT.TIAD)or, 
Sraddress if extenderl/O (CDT.SIAD) 



X^Vl 



-TT) d '^^ O -^2.-<^>'^^^ ' 



UDT address unit 0* (CDT.UTO) 



UDT address Unit 1* (CDT.UTlf 



J^ 



UDT address unit 15* (CDT.UTF) 



♦Initialized by SYSGEN 
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Notes 

1. Always zero (head cell) 

2. Number of entries in list (zero if none) 

3. Bits in CDT.CLAS are assigned as follows. 

X'OD' TCW type with extended addressing capability 
X'OE' TCW type 
X'OF' Extended I/O 

4. Bits in CDT.FLGS are assigned as follows, 

Extended I/O device (CDT.FCLS) 

1 I/O outstanding (set by handler, reset by IOCS) (CDT.IOUl) 

2 GPMC device (CDT.GPMC) 

3 Set if initialization (INC) needs to be performed for this controller 
(CDT.FINT) 

4 Set if D class (16MB GPMC) (CDT.XGPM) 

5 Used only when lOQs are linked to the CDT. Set when SIO is accepted by 
controller. Reset when lOQ is unlinked from CDT or when I/O is reported 
complete to IOCS in the case of operator intervention type errors 
(CDT.I0U5). 

C T-F «af TOD onnhT<r>l1pi> (CTsT THD^ 

7 If set, controller malfunction (CDT.MALF) 
5.. Bits in CDT.IOST are assigned as follows. 

If set, lOQ linked to UDT (CDT.NIOQ) 

1 Multiplexing controller (CDT.MUXC) 

2 If set, use standard XIO uiterface 

3 If set, D-class GPMC (CDT.XGPS) 

4 If set, cache controller (CDT.CAC) 

5 If set, H.F8XIO has determined if the controller is pre-8512-2 or not 
(CDT.CKFL) 

6 If set, controller not pre-8512-2 (CDT.FLOW) 
. 7 Reserved for FMS 

6. CDT.SIZE = 24W 
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2.8 Device Context Area (DCA) 

A Device Context Area (DCA) exists for each active subchannel and serves as a storage 
area for information regarding the subchannel and its operation. The DCAs are 
physically located at the end of each device dependent handier (H.??XIO). The first 33 
words of each DCA are identical; however, additional words may be added to suit the 
needs of the particular device. The following represents the first 33 words of each DCA. 



7 8 



15 16 



23 24 



31 




2 ^ 
3 

4 - 
5 

6 A 



DCA size (DCA.SIZE) 



DevicS'acidressIDCA.UADD) ^O^O^) Reserved 



CHT address (DCA.CHTA) 



I 



CDT address (DCA.CDTA) 



UDT address (DCA.UDTA) 



lOQ address (DCA.IOQA) 



Lost interrupt count (DCA.LINC) 



Spurious interrupt count (DCAsSINC) 



Total retry count this device (DCA.RETC) 



lu T»«4iJu I address ^uua.inuu i ; aee iNote z. 
11, 



12 /- 

13 

14 

15 

29 

30 
31 

32 



Flags (DCA.FLAG) See Note 1 



Status word 1 (DCA.WST1) 



Status word 2 (DCA.WST2) 



Number of reserves outstanding (DCA,RESC) 



Time out value opcode (DCA.TIMO) See Note 3 



Time out value opcode 1 See Note 3 
Time out value opcode F See Note 3 



Sense IGCD (DCA.SENI) 



Sense buffer (DCA.SENS) 



'iGZ.O 



3eh0 






Retry count 
this request 
(DCA.RCNT) 



''-■'4i 



MPX-32 
Technical Manual 



System Tables 
and Variables 



2-31 



Notes 

1. Bits in DCA.FLAG are assigned as follows. 

If set, interrupts not expected 

1 If set, HIO issued at LI.XIO 

2 If set, HIO needs to be reissued 

3 If set, device rewinding or seeking 

4 If set, sense issued without an lOQ •»* — 

5 If set, device is an XIO magnetic tape 
6-15 Reserved for common subroutine usage 
16-23 Reserved for device dependent handler usage 

2. This UDT address is the UDT address of the device for which a SIO or HIO was issued 
when a status stored response was generated on behalf of this device. It indicates 
the need to reissue the I/O request for that device. 

3. Time out values corresponding to opcodes through F (16 entries). -«, 
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Dispatch Queue Entry (DQE) Table 



Word// 

(Decimal) 

Q 

1 

2 

3 

4-5 

6-7 

8-9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

o c 
CJ 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 . 

36 

37 
38-40 

41 
42-43 
44-51 

52 

53 

54 

55 

56 

57 



Byte 
(Hex) 

4 
8 
C 

10 

18 

20 

28 

2C 

30 

34 

38 

3C 

40 

44 

48 

4C 

50 

54 

58 

5C 

60 

68 
6C 
70 
74 
78 
7C 
80 
84 
88 
8C 
90 
94 
98 
A4 
A8 
BO 
DO 
D4 
D8 
DC 
EO 
E4 



7 8 



15 16 



23 24 



31 



DQE.SF 


DQE. SB 


DQE.OUP 




DQE.BUP 


DQE.IOP 


DQE. US - 


DQE. NUM/ DQE. TAN 


DQE. ON 


DQE.UVN 


DQE.PSN 








■V. 


DQE.USW 








„;:■'■: 


DQE.USHF .^ f 


DQE.MSD 










Reserved 










DQE.IVMSG 


DQE.rvRUN 


DQE.rvt^I 


DQE.QQFN 


DQE.UF2 


DQE. IPUF 


DQE.NWIO 


DQE.50P0 


DQE.CQC 










Reserved 






DQE.TIFC 


DQE.RILT ' 


DQE.UTSl 






«. 




DQE.UTS2 


DQE.DSW 


DQE.PRS 


DQE.PRM 










Re s e r V e d 








t:x3e:.MST 


DQE.P5SF i 


DQE.PSSB 








■ 


DQE.PSPR 


1 


DQE.PSCT 


DQE.ILN 


DQE.RESU 


DQE.TISF 


DQE.TISB 








1. 


DQE.TIPR 


1 


DQE.TICT 


DQE.SWIF 


DQE.UBIO 


DQE.RRSF 


DQE.RRSB 










DQE.RRPR 


1 


DQE.RRCT 


DQE.NSCT 




DQE.rvRSF 


DQE.IVRSB 


DQE.N/RPR 




DQE.IvRCT 


DQE.ISMRR 


DQE.NVVTv/R 


DQE.RTI 




Reserved 


DQE. ATI 


Reserved 


DQE.SAIR/ 


1X4- 


.TAD 






DQE. ABC 1 


LXJE.rvPP 










DQE.SRID 










DQE.CDIF ' 


v; 


3E 


.CVOL 


- 




DQE.ACXl 










DQE.ACX2 










DQE.IvRQ • 


DQE.rvEM 


DQE.N/ENR 




DQE.NRT 


Reserved 


DQE.RMvR 




DQE.rvK\PN 


DQE.dvE 1 


DQE.OvH 


DQE. CMS 
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Symbol Item Description 

DQE.SF String forward linkage address; 

Standard linked list format; 
Contains address of next (top-to-bottom) entry in chain. 



DQE.SB String backward linkage address; 

Standard linked list format; 
Contains address of next (bottom-to-top) entry in chain. 



DQE.CUP Current user priority; 
Field length = IB; 
Standard linked list format; 

This priority is adjusted for priority migration based on 
situational priority increments. Situational priority increments 
are based on the base level priority (DQE.BUP) of the task. 

DQE.BLP Base priority of user task; 
Field length = IB; . 

Used by scheduler to generate DQE.CLP (current priority) based 
on any situational priority increments. 

DQE.ICP I/O priority; 

Field length = IB; 

Initially set from base priority; 

DQE.US State chain index for this user task; 

Field length = IB; 
Range: Zero thru X'lE'; 

Indicates current state of this task e.g., ready-to-run priority, I/O 
wait, resource block, etc.. 

Label Index Description 



FREE 
PREA 
CURR 



00 
01 
02 



_S9BI— 05= 
SQ55 04 



DQE is available (in free list) 

Task activation in progress 

Task is currently executing task or is 

preempted time distribution task in quantum 

stage 1 



SQ56 

SQ57 

.SQ58^ 

SQ59 

SQ60 

SQ61 

SQ62 

SQ63 

SQ64 

SWTI 



05 

06 

07 

08 

09 

OA 

OB 

OC 

OD 

OE 



Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 
Task 



s ready to run (PRI. LEV. 1-54) 
s ready to run (PRI. LEV. 55) 
s ready to run (PRL LEV. 56) 
s ready to run (PRI. LEV. 57) 
s ready to run (PRL LEV. 5a) 
s ready to run (PRL LEV. 59) 
s ready to run (PRL LEV. 60) 
s ready to run (PRL LEV. 61) 
s ready to run (PRL LEV. 62) 
s ready to'run (PRL LEV. 63) 
s ready to run (PRL LEV. 64) 
s waiting for terminal input 
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SWIO 


OF 


SWSM 


10 


SW5R 


11 


SWLO 


12 


SUSP 


13 



RUNW 14 



HOLD 
ANYW 



SWDC 

SWDV 

SWFI 

MRQ 

SWMP 

SWGQ 

CPU 



15 
16 



17 

18 

19 

lA 

IB 

IC 

ID 



Task is waiting for I/O 
Task is waiting for message complete 
Task is waiting for run req complete 
Task is waiting for low speed output 
Task is waiting for: 

1) timer expiration, or 

2) resume request, or 

3) message interrupt 
Task is waiting for: 

1) timer expiration, or 

2) run request 

Task is waiting for a continue req. 
Task is waiting for: 

1) timer expiration, or 

2) no-wait I/O complete, or 

3) no-wait msg complete, or 

4) no-wait run req complete, or 

5) message interrupt, or 

6) break interrupt 

Task is waiting for disc sprace 
Task is waiting for dev allocation 
Task is waiting for file system 
Task is waiting for memory 
Task is waiting for memory pool 
Task is waiting in general wait queue 
Current IPU task in execution 



DQE.NUM DQE entry number; 
Field length = IB; 

Used as an index to DQE address table (DAT); 
Range: One thru "N" (for MPL index compatibility); 
Used by scheduler to set C.PRNO to reflect the currently 
executing task. 

This value is also used as the MPL index. It is used by the 
scheduler to initialize the CPIX in the PSD before loading the 
map for this task. 

DQE.TAN Task activation sequence number; 
Field length = IW; 

This number is assigned by the activation service and uniquely 
identifies a task. 

NOTE: The most significant byte of this value is the DQE entry 
number and may be accessed as DQE.NUM. 



10 DQE. ON Owner name; 

Field length = ID 



18 



DQE.LMN 



Load module name; 
Field length = ID 
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20 DQE.PSN Pseudonym associated with task; 

Field length = ID; 

This parameter is an optional argument accepted by the pseudo 
task activation service. It may be used to uniquely identify a task 
within a subsystem, for example, multibatch. It contains 
descriptive information useful to the system operator or to other 
tasks within a subsystem. Conventions used to generate a 
pseudonym are determined by the associated subsystem. A 
system-wide convention should be used to establish pseudonym 
prefix conventions to avoid confusion between subsystems. 



28 



DQE.USW 



User status word; 
Field length = IW 



2C DQE.USHF Scheduling flags; 

Field length = IW; 
Used by the scheduler to indicate special status conditions. 



Bit 



Label 



Description 



00 DQE.LPI Load protection image requested 

01 DQE.SING Single copy load module 

02 DQE.INDC Task is indirectly connected 

03 DQE.PRIV Task is privileged 

04 DQE.MSGR Task has message receiver 

05 DQE.BRKR Task has break receiver 

07 DQE.QS2X Task quantum stage 2 expired 

DQE.INER Inswap I/O error 
DQE.WIOA Wait I/O request outstanding 
DQE.WIOC Wait I/O complete before in-progress 

notification 

Inhibit message pseudo interrupt 

Batch origin task 

Running in TSM environment 

Task abort in progress 

Task is in preexit state 
16^ DQE.RRMD Run receiver mode 

17 DQE.WMSA Wait-send msg outstanding 

18 DQE.WMSC Wait msg complete before link to wait 

queue 

19 D(^-.WRRA Wait mode send run request outstanding 

20 DQE.WRRC Wait mode send run request complete 

before link to wait queue 

21 DQE.DBAT Debug associated with task 

22 DQE.RT Real time task 

23 DQE.TDID Time distribution task initial dispatch. 

Set by: 

1. H.ALOCl on activation of T/D task 

2. S.EXEC51 when task is linked to WAIT 
state 

3. H.EXEC7 on completion of inswap or 
other memory request 



08 
09 
10 

11 
12 
13 
14 
15 



DQE.INMI 
DQE.BAOR 
DQE.TMOR 
DQE.ABRT 
nOF .PRXT ^ 
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24 
25 

26 
27 
28 
■ 29 
30 
31 



Cleared by S.EXEC20 on initial dispatch 

of task after activation, wait-state 

termination, or inswap. 
DQE.DELP Task delete in progress 
DQE.ABRA Task abort (with abort receiver) in 

progress 
DQE.ABRC Abort receiver established 
DQE*ADIN Asynchronous abort/delete inhibited 
DQE.ADDF Asynchronous delete deferred 
DQE.INAC Task is inactive 
DQE.AADF Asynchronous abort deferred 
DQE.ACTT Activation timer in effect 



30 

34 
38 



3C 



DQE.MSD Physical address of MIDL in TSA; 
Field length = IW 

Reserved Field length = IW 

DQE.MMSG Maximum number of no wait messages allowed to be sent by this 
task; 
Field length = IB 

DQE.MRUN Maximum number of no-wait run requests allowed to be sent by 
this task; 
Field length = IB 

DQE.MNWI Maximum number of no-wait I/O requests allowed to be 
concurrently outstanding for this task; 
Field length = IB 

DQE.GQFN Contains the generalized queue (SWGQ) function code; 
Field length = IB 

01 = Queued for volume resource (QVRES) 

02 = Queued for ART space (QART) 

03 = Queued for mount in progress (QMNT) 

04 = Queued for resourcemark lock (QRSM) 

05 = Reserved for eventmark (QEVM) 

06 = Queued for read wait for writer (QGEN) 

07 = Queued for Shared Memory Table (QSMT) 

08 = Queued ^or synchronous resource lock (QSRL) 

09 = Queued lur Mounted Volume Table (QMVT) 
OA = Queued for dual port lock (QDPLK) 

DQE.UF2 Scheduling flags; 
Field length = IB 

Bit Label Description 

DQE.EDB Enable debug mode break 

1 DQE.GQTO Generalized wait queue time-out 

2 DQE.SYNC Task interrupts are synchronized 

3 DQE.JOB Task is part of a job 

4 DQE.ACX ACX-32 task flag 
5-7 Reserved 
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DQE.IPUF 



IPU flag byte 
Field length = IB 



Bit 


1 
2 

4 
5 
6-7 



Label 

DQE.PUH 
DQE.IPUB 
DQE.IPUR 
DQE.OSD 

DQE.BASE 
DQE.AbA 



Description 

IPU inhibit flag 

PL) bias flag 

CPU only 

OS execution direction flag (set when PSD 

is in user area) 

Base register task 

Ada task 

Reserved 



DQE.NWIO Number of no-wait I/O requests 
Field length = IB 

DQE.SOPO Priority bias only swapping control flags; 
Field length = IB 

Bit Label Description 

DQE.GQPO SWGQ state priority based swapping 

1 DQE.BMAP Swap inhibit due to bit map access 
2-7 Reserved 
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DQE.CQC Current quantum count; 



cr: 



CAU xCiiyuii — Jk if } 



Used by the scheduler to accumulate elapsed execution time for 
the task for comparison with the level unique stagel and stage2 
time distribution values. 



44 



Reserved Field length = IH 



DQE.TIFC 



48 



DQE.RILT 



DQE.UT51 



Timer function code; 
Field length = IB; 

00 = Not active 

01 = Request interrupt 

02 = Resume program from 

03 = Resume program from 

04 = Resume program from 

05 = Resume-program from 

06 = Resume program from 

07 = Resume program from 



suspend (SUSP) queue 
any-wait (ANYW) queue 
run-request-wait (RUNW) queue 
generalized (SWGQ) queue 
peripheral device (SWDV) queue 
disc space (SWDC) queue 



Request interrupt (RI) level for timer; 

Field length = iB; 

Identifies the interrupt level to be requested upon 

expiration. 

User timer slot word 1; 

Field length = IW; 

Current timer value; 

Contains negative number of timer units before time-out. 



timer 
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4C DQE.UTS2 



User timer slot word 2; 

Field length = IW; 

Reset tinner value; 

Contains negative number of time units; 

Used to reset the current timer value when it expires. 



50 DQE.DSW 



Base mode debugger status word (PCALL); 
Field length=lW. 



54 DQE.PRS 



Peripheral requirement specification; 
Field length = IW; 

Bit Description 

0-7 Reserved 

8-15 Device type code 

16-23 Channel address 

24-31 Subchannel address or contains first word of SWGQ id 
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DQE.PRM Peripheral requirements mask; 



Field length = IW; 

X'OOFFOOOO' 

X'OOFFFFOO' 



X'OOFFFFFF' 



Any device of this type code 

Any device of the specified type code on the 

specified channel 

The specified device as described by type 

code, channel, and subchannel address, or 

contains second word of SWGQ id. 



5C Reserved 

DQE.MST 



60 



DQE.P5SF 



Field length = 38, 

Static memory type specification; 
Field length = IB; 

01 = Class 'E' memory 

02 = Class 'H' memory 

03 = Class '5' memory 

This field is sed to specify the type of memory required for 
inswap. 

Preemptive system service head cell 

String forward linkage address; 

Standard head cell format; 

Field length = IW; 

Contains address of next (top-to-bottom) entry in chain. 



64 



DQE.PSSB 
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Preemptive system service head cell 

String backward linkage address; 

Standard head cell format; 

Field length = IW; 

Contains address of next (bottom-to-top) entry in chain. 
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68 DQE.PSPR Preemptive system service head cell 

Dummy priority (alv/ays = 0); 
Standard head cell format; 
Field length = 1B« 

DQE.PSCT Preemptive system service head cell 
Number of entries in list; 
Standard head cell format; 
Field length = IB; 



DQE.ILN 



DQE.RESU 



Interrupt level number; 

Field length = IB; 

Identifies associated interrupt level for interrupt connected tasks. 

Reserved usage index 
Field length = IB 



6C DQE.TISF Task interrupt head cell 

String forward linkage address; 

Standard head cell format; 

Field length = IW; 

Contains address of next (top-to-bottom) entry in chain. 



70 DQE.TISB Task interrupt head cell 

String backward linkage address; 

Standard head cell format; 

Field length = IW; 

Contains address of next (bottom-to-top) entry in chain. 



74 



DQE.TIPR 



DQEeTICT 



DQE.SWIF 



Task interrupt head cell 
Dummy priority (always = 0); 
Standard head cell format; 



Field length = IB 



Task interrupt head cell 
Number of entries in list; 
Standard head cell format; 
Field length = IB; 

Swapping inhibit flags; 
Field length ='1B; 
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Bit 


Label Description 



1 
2 
3 
4 
5 


DQE.RESP Task is resident 
DQE.LKIM Task is locked in memory 
DQE.IO Task has unbuffered I/O in progress 
DQE.OTSW Task is outswapped 
DQE.TLVS Task is leaving system 
DQE.FCUS Task forced' unswappable during terminal 
output 
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6 DQE.FCRS Task forced unswappable because swap 

file has not been allocated for it 

7 DQE.INOS Task is imbedded in the operating system 

DQE.UBIO Number of unbuffered I/O requests currently outstanding; 
Field length = IB. 



78 DQE.RRSF Run receiver head cell 

String forward linkage address; 

Standard head cell format; 

Field length = IW; 

Contains address of next (top-to-bottom) entry in chain. 



7C DQE.RRSB Run receiver head cell 

String backward linkage address; 

Standard head cell format; 

Field length = IW; 

Contains address of next (bottom-to-top) entry in chain. 



80 DQE.RRPR Run receiver head cell 

Dummy priority (always = 0); 
Standard head cell format; 
Field length = IB. 

DQE.RRCT Run receiver head cell 

Number of entries in list; 
Standard head cell format; 
Field length = IB; 

DQE.NSCT Number of map blocks out swapped; 
Field length = IH. 



84 DQE.MRSF Message receiver head cell 

String forward linkage address; 

Standard head cell format; 

Field length = IW; 

Contains add of next (top-to-bottom) entry in chain. 



88 DQE.MRSB Message receiver head cell 

String backward linkage address; 

Standard head cell format; 

Field length = IW; 

Contains address of next (bottom-to-top) entry in chain. 
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8C DQE.MRPR Message receiver head cell 

Dummy priority (always = 0); 
Standard head cell format; 
Field length = IB. 

DQE.MRCT Message receiver head cell 
Number of entries in list; 
Standard head cell format; 
Field length = IB; 

DQE.NWRR Number of no-wait mode run requests outstanding; 
'Field length = IB. 

DQE.NWMR Number of no-wait mode msg requests outstanding; 
Field length = IB. 



90 



DQE.RTI 


Requested task interr 
Field length = IB; 


upt flags; 




Bit 


Label 


Description 





1 

2 

3 
4 


DQE.EA1R 

DQE.DBBR 
DQE.UBKR 
DQE.EA2R 


Reserved 

Priority 1 end action request 

preemptive system services. 

Debug break request 

User break request 

End action request (priority 2) 




5 
6-7 


DQE.MSiR 


Message interrupt request 
Reserved 


Reserved 


Field 


length = IB 




DQE.ATI 


Active task interrupt flags; 
Field length = IB. 




Bit 


Label 


Description 





1 
2 
3 
4 
5 
6-7 


DQE.AEA1 

DQE.ADM 

DQE.AUB 

DQE.AEA 

DOe.AMI 


Reserved 

Active end action priority 1 

Active debug break 

Active user break 

Active end action priority 2 

Active message interrupt 

Reserved 



Used for 



Reserved Field length = IB 
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94 DQE.SAIR System action task interrupt request; 

Bit Label Description 

DQE.DELR Request for delete of this task 

1 Reserved 

2 DQE.HLDR Hold task request 

3 DQE.ABTR Abort task request 

4 DQE.EXTR Exit task request 

5 DQE.SUSR Suspend task request 

6 DQE.RRRQ Run receiver mode request 

7 Reserved 

DQE.TAD TSA address (logical); 

Field length = IW (byte contains DQE.SAIR) 



98 DQE.ABC Abort code; 

Field length = 3W 



A4 DQE.MPP Memory pool pointer; 

Field length = IW 



A8 DQE.SRID Used swapspace linked list; 

Field length = 2W 



BO DQE.CDIR Load module RID at activation; 

Field length = BW 

DQE.CVOL Current working volume at activation; 
Field lenoth = BW 



DO DQE.ACXl Outswap time; 

Field length = IW 



D4 DQE.ACX2 Advance communication word 2; 

Field length = IW 

D8 DQE.MRQ Memory request doubleword; 

Reserved Field length=lB 

DQE.MEM Type of memory requested; 
Field length = IB; 
01=Class 'E' memory 
02=Class 'H' memory 
03=Class 'S' memory 

DQE.MEMR Number of memory blocks required; 
Field length=lH; 
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DC DQE.MRT Memory request type code; 

Field length=lB; 
00=lnswap only 
01=Preactivation request 
02=Activation request 
03=Memory expansion request 
04=IOCS buffer request 
05=Shared memory request 
06=System buffer request 

I.f DQE.MRT equals 05, the next three bytes will contain the 
address of the Shared Memory Table entry. 

Reserved Field length=lB 

DQE.RMMR Map register for requested memory; 
Field length=lH 



EO DQE.MAPN Inclusive span of maps in use; 

Field length=lH 

DQE.CME Number of swappable class "E' map blocks currently allocated; 
Field length=lH 



E4 DQE.CMH Number of sv/appable class 'H' map blocks currently allocated; 

Field length=lH 

DQE.CMS Number of swappable class 'S' map blocks currently allocated; 
Field length=lH 
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2.14 File Assignment Table (FAT) 

The File Assignment Table (FAT) is used to provide an association between a logical file 
code (LFC) and a resource. It also coordinates access to the resource referenced via an 
LFC. The FAT is linked to the Unit Definition Table (UDT) and the Controller Definition 
Table (CDT) when the resource is allocated. 

The FAT must contain information related to the requestor of the resource such as 
position within the file (segment and byte within the segment) and current access mode. 
For efficiency considerations, information pertaining to allowable access modes, 
segmentation, and extendibility are also included. 



Word 








7 8 



15 16 



23 24 



31 



Status 
bits 

(DFT.STB) 
See Note 1 



Access flags 
or system 
file code 
(DFT.ACF) 
See Note 2 



CDT index (DFT.CDTX) 



UDT index (DFT.UDTX) 



Flags 

(DFT.FLGS) 
See Note 3 



Number of 
FPTs 
assigned 
(DFT.NAS) 



Segment definition area address (DFT.SEGA) or 
Volume name for dismount message (DFT.VNAM) 



Relative file block position (DFT.POSj 



RKJatiVti EQm uiucK positiuii \ui 

Relative EOF block number (DFT.EOF) 



. _ . M««-« A 



Number of segments (DFT.NSEG) 



Current segment position 
in file (DFT.CSEG) or 
Device specification 
mask (DFT.MASK) 



Append record pointer (DFT.AREC) 



Relative end block 
number of current 
segment (DFT.SEGE) or 
Unformatted medium 
identifier (MTF.REEL) 



8 
9 

10 
11 



12 
13 
14 
15 



File attributes field (DFT.ATTR) See Note 5 

Append block number (DFT.ABLK) or 

Volume number for multivolume media (MTF.VOL) 



Blocking buffer head cell address (DFT.BBAJ 



Associated 
VAT index 
(DFT.VATX) 



Number of 
opens on 
this FAT 
(DFT.OPCT) 



Current access 
mode (DFT.CACM) 



Resource type 
code (DFT.TYPE) 



Address of parent directory resource descriptor (DFT.PDIR) 
Relative offset of parent directory entry (DFT.DOFF) 



Allocated Resource Table entry pointer (DFT.ARTA) 
Assigned access restrictions (DFT.ACCS) See Note 6 
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Notes 

1. Bits in DFT.STB are assigned as follows. 

If set, file open 

1 If set, file opened read/write 

2 If set, permanent file ~^ "' 

3 If set, blocking buffer output active 

4 If set, unformatted medium 

5 If set, volume resource 

6 If set, read only access 

7 If set, TSM associated FAT 

2. Bits 04 in UFT.ACF are assigned as follows. 
Volume resource only: 

0-1 Reserved 

2 If set, "$" read on SYC ' 

3-4 Reserved 

Unformatted medium only: 

If set, mount message has been inhibited or tape is shared 

1 If set, multivolume tape 

2 If set, mount message has been output 

3 If set, tape at EOT 

4 If set, tape at EOT 

bits 0~l in ur I .Mi_r appiy umy uu vuiumo uoatjc^ ai.ui «.x* ^.»..vu... -...- w. — 

following values. 

Value=0 Not a system file — «— 

Value=l SYC file 

Value=2 SGO file 

Value=3 SLO file 

Value=4 SBO file 

3. Bits in DFT.FLGS are assigned as follows. 

Blocking buffer present 

1 SMAP or DMAP assignment 

2 Reserved 

3 If set, file has been assigned to the NULL device • 

4 If set, this FAT entry is not in use 

5 If set, TSM I/O (task is swappable) ^ ^ 

6-7 Reserved 

4. Byte 3 of Word 4 contains tape density for high speed tape (DFT.DENS) and EOM 
does not apply (DFT.EOM). 

5. Bits in DFT.ATTR are assigned as follows. 

If set, file is automatically extendable 

1 If set, file is implicitly shared 

2 If set, file data has been modified 

3 If set, unblocked specified at assignment 

4 If set, file opened for random access 

5 If set, file opened in blocked mode 

6 If set, expanded FCB 

7 If set, resource descriptor opened for modify 
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8 If set, current access mode specified at assignment 

9 If set, resource to be marked blocked at close 

10 If set, enqueue inhibit 

11 If set, spool option requested 

12 If set, EOF update required 

13 Reserved for IOCS 

14 If set, file assigned to nonpublic volum.e 

15 If set, segmented file 

16 If set, task in resource queue when deleted 

17 If set, the date and time of last change field in the resource descriptor will 
not be changed on a rewrite 

18-31 Reserved 

6. Bytes in DFT.ACCS are assigned as follows. 

Bytes 0-1 Contain bit pattern from RR.ACCS if specified at assignment (see 

Section 2.31 for details on RR.ACCS). If not specified, contains 
the bit pattern from the appropriate access restriction field 
(RD.AOWNR, RD.AUGRP, RD.AOTHR) in the resource 
descriptor. See M.RDCOM, Section 2.41.1 for details. 

Byte 2 Bits are assigned as follows. 

If set, assigned for explicit shared use 

1 If set, assigned for exclusive use 
2-7 Reserved 

associated resource descriptor. See M.RDSPD, Section 2.41.2 for 
details. 
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2J.5 FUe Control Block (FC8) 

The File Control Block (FCB) is used to convey information about requested I/O 
operations and to report their status to the requestor. The table entry is generally 
located in the t ask's ad dress space. 

The task's FCB is linked to the File Assignment Table (FAT) when the resource is 
opened. This completes the logical connection from the task to the requested resource 
for subsequent use. The FCB is then linked to an I/O Queue (lOQ) entry when an 
operation for that logical connection is requested. When this is done, the status for the 
requested operation code is posted in the respective FCB. 



n 




3 4 



7 8 



11 12 



15 16 



23 24 



31 



^ 



/ 



t/' 



14 



4 
5 
6 

7 

8 

9 

, 10 



2y 



Reserved Opcode 

l(FCB.OPCD) 

Quantity (FCB.TCW) 



Logical file code (FCB.LFC) 



General control 
flags (FCB.GCFG) 



Status flags 
(FCB.SFLG) 



Special flags 
(FCB.SCFG) 



Test status 



Data Address 



Random access 
address (FCB.CBRA) 



DCC status 



Console teletype 
flag (FCB.CONF) 



Device status 



Record length (bytes) (FCB.RECL) 



Reserved 



Special 

status 

(FCB.SPST) 



Reserved 



Index to FPT 



Reserved 



I/O queue address (FCB.IOQA) 



Wait I/O error return address (FCB.ERRT) 



FAT address (FCB.FATA) 



Expanded data address (FCB.ERWA) 



Expanded transfer quantity (bytes) (FCB.EQTY) 



Expanded random access address (FCB.ERAA) 



Extended I/O status word 1 (FCB.ISTl) 



Extended I/O status word 2 (FCB.IST2) 



Reserved 



Reserved 



No-wait I/O normal end action service address 
(FCB.NWOK) 



No-wait I/O error end action service address 
(FCB.NWER) 



,^ 15 User-supplied blocking buffer address and number of 192 W buffers (FCB.BBA) 
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WORDO 


Bits 0-3 


Bits 4-7 


Bits 8-31 


WORDl 


Note: Words i 


Bits 0-11 



This field is always zero. 

Operation code - A single hexadecimal digit specifies the type of 
function requested of the device handler. The allowable functions and 
their definitions are unique to each peripheral device. 

Logical file Code - Any combination of three ASCII characters is 
allowed. 



Words 8 and 9 are used instead of Word 1 if Bit 6 of Word 2 is set. 

Quantity - Three hexadecimal digits specify the number of data items 
to be transferred. This quantity must include the carriage control 
character, if applicable. The transfer quantity is in units determined 
by the address in bits 12-31. 

Bits 12, Format Code - These bits specify byte, half word or word addressing 

30,31 for data transfers. They are interpreted as follows: 

Type of 
Transfer 





(30,31) 


1 


00 


1 


01 


1 


10 


1 


11 





01 





11 


. 


00 



ByteO 

Bytel 

Byte 2 

Byte 3 

Left Halfword 

Right Halfword 

Word . 



If a halfword or word transfer is specified for a device which accepts 
only bytes, IOCS adjusts the quantity accordingly. If a byte transfer 
is specified for a device which accepts only halfwords or words, IOCS 
will adjust the quantity accordingly if the number of bytes is an even 
multiple of the requested transfer mode and the data address is on the 
correct boundary. Otherwise, the request is treated as a specification 
error. 

Bits 13-29 Data Address - The initial address data areas for read or write 
operations. 
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WORD 2 



Bits 0-7 General Control Specifications - These eight bits enable the user to 

specify the manner in which an operation is to be performed by 
IOCS. The interpretation of these bits is shown below: 

Bit Meaning 

If set, IOCS will return to the user immediately after the I/O 
operation is queued. If reset, IOCS will exit to the calling program 
only when the requested operation has been completed. 

1 If set, error processing will not be performed by either the device 
handler or IOCS. An error return address is ignored and a normal 
return will be taken to the caller, however the device status will be 
posted in the FCB (unless bit 3 is set). If reset, normal error recovery 
will be attempted. Normal error processing for disc and magnetic 
tape is automatic error retry. Error processing for unit record 
devices except the system console is accomplished by IOCS typing the 
message "INOP" to the console which allows the operator to retry or 
abort the I/O operation. If the operator aborts the I/O operation, or 
if automatic error retry for disc or magnetic tape is unsuccessful, an 
error status message is typed to the console and the error return 
address will be taken if provided; otherwise, the task is aborted. 

2 If set, data formatting is inhibited. Otherwise, data formatting is 
performed by the appropriate device handler. See Bit 8 for further 
explanation. 

3 If set, the device handlers perform no status checking and no status 
information is returned. Hence all I/O will appear to complete 
without error. Otherwise, status checking is performed and status 
information is returned as necessary. 

4 If set, file accessing will occur in the random mode. Otherwise, 
sequential accessing will be performed. 

5 If set, a blocked file is specified (disc or tape assignments only). 

6 Expanded FCB present (Words 8-15). This takes advantage of a larger 
I/O transfer quantity in bytes, a 24-bit addressing field, and a 32-bit 
random access address. For Extended I/O operations, up to two 
interrupt status words are then returned after I/O complete. When 
this bit is set, IOCS assumes the FCB is 16 words long. The 
information in Words 8 and 9 is used instead of the data in Word 1. 
Also, the random access address in Word 10 is used instead of the data 
in word 2. 

7 This bit is reserved for internal IOCS use. If set, it indicates the 
user's FCB is being used for physical I/O during blocked data handling 
and the FCB parameters are in the task's scratchpad. 
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Bit 8 Device Format Definition - If set, special definitions for 7-track 

magnetic tape, ALIMs, etc. are indicated in bits 9-12. Normally, bit 8 
is examined only when bit 2 (data formatting inhibit) is set. The 
meaning is interpreted as shown in Section 2.15.1. 

Bits 9-12 Special Control Specification - this field contains device control 

specifications unique to certain devices. Interpretation and 
processing of these specifications are performed by the device 
handlers. A bit setting is meaningful only when a particular type of 
device is assigned as indicated in Section 2.15.1, columns 2 and 3. 
(Column 1 indicates default control). 

Bits 13-31 Random Access Address - This field contains a block number (zero 
origin) relative to the beginning of the disc file, and specifies the base 
address for read or write operations. 

If bit 6 of Word 2 is set, the expanded random access address in Word 
10 (FCB.ERAA) is used instead of bits 13-31. 

For devices where random access is invalid, bits 13-31 have the following assignments: 

Bit 13 If set, software read flow control required (FCB.RXON). 

Bits 24-31 Console Teletype Type Control Parameter Block Flag Type. 

For High Speed Data (HSD) interface applications, Word 2 bit meanings are as follows: 

Bit 8 Request Device Status After Transfer - This bit indicates an lOCB 

should be added to the lOCL to retrieve device specific status after 
the data transfer has completed. 

Bit 9 Send Device Command Prior to Data Transfer - This bit indicates an 

IOCS should prefix tffe data transfer to transmit a device command 
word to the device. The value sent is the 32-bit expanded random 
access address. 

Bit 10 Disable Timeout for this Request - This bit indicates the operation 

will take an indeterminable period of time and the handler should wait 
an indefinite period of time for the I/O to complete. This generally 
only has meaning on read operations. 

Bit 11 Set UDDCMD from Least Significant Byte of Word 2 - This bit 

indicates the UDDCMD byte in the data transfer IQCB should be set 
to the least significant byte of the random access field of the FCB. 
This provides the ability to pass additional control information to the 
device without modifying the device driver. • 

Bits 24-31 If bit 11 is set, these bits define the UDDCMD field of the generated 

IQCB, overriding the default value from a handler table. 
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WORD 3 

Bits 0-31 Status Word - 32 indicator bits are used by IOCS to indicate the 

status, error and abnormal conditions detected during the current 
or previous operation. The assignment of these bits is shown 
belows 



Bit Meaning 

Operation in progress. (Request has been queued.) 
(Note: Reset after post I/O processing complete.) 

1 Error condition found. 

2 Invalid Blocking Buffer* control pointers have been encountered during file 
blocking or deblocking. 

3 Write protect violation. 

4 Device inoperable. 

5 Beginning-of-medium (BOM) (load point) or illegal volume number (multi- 
volume magnetic tape). 

6 End-of-file. 

7 End-of-medium (end of tape, end of disc file). 



Nonextended I/O Devices: 

8-11 Specifies general testing status as received from an 8000 level Test 

Device instruction. 

12-15 Specifies DCC testing status as received from a 4000 level Test Device 

instruction. 

16-31 Specifies a device status as received from a 2000 level Test Device 

instruction. These bits are not applicable for the Paper Tape, Card 
Reader, and Teletypewriter. Bit meanings for 2000 level testing for non- 
extended I/O devices are shown in Section 2.15.2. 
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FCB Word 
3 Bits 


16 


17 


18 


19 


20 


21 


22 


23 


24 


AliF- 
Class 
Devices 


ECHO 


PPCI 


INCORRECT 
LENGTH 


PROGRAM 
CHECK 


DATA 
CHECK 


CONTROL 
CHECK 


INTERFACE 
CHECK 


CHANNEL 
CHAINING 
CHECK 


BUSY 


High 

Speed 

Data 

Interface 

(Generic 

Handler) 

D-Class 


CD 

TERMI- 
NATION 


ERROR STATUS FORMAT 
(See Word 3 description) 

4 


GPMC 


DEVICE DEPENDENT 



FCB Word 
3 Bits 


25 


26 


27 


28 


29 


30 


31 


ALLF- 

Class 

Device 


STATUS 
MODIFIER 


CONTROLLER 
END 


ATTENTION 


CHANNEL 
END 


DEVICE 
END 


UNIT 
CHECK 


UNIT 
EXCEPTION 


Hiqh 

Speed 

Data 

Interface 

(Generic 

Handler) 

D-Class 


EXTERNAL 
TERMINATION 


lOCB 

ADDR 

ERROR 


ERROR 

ON 

TI ADDR 

FETCH 


DEVICE 
EOB 


EP5 

ERROR 
PRE- 
CLUDED 
REQUEST 
QUEUEING 


NONEXECUTIVE 

CHANNEL PROGRAM 

lOCB TYPE IN 

ERROR 

00-DATA TRANSFER 

01-DEV STATUS 

10-COMMAND 

TRANSFER 


GPMC 


DEVICE 
DEPENDENT 


TRANS- 
MISSION 
ERROR 


INCORRECT 
LENGTH 


UNUSUAL 
END 


ILLEGAL 
ORDER 


INTERRUPT 
PENDING 


CHANNEL 
END 



For Extended I/O Devices Only 



Bit 



Meaning 



8 Zero 

9 Zero 

10 Last command exceeded time out value and was terminated. 
11-15 Zero 

16-23 Channel status (see Section 2.15.3) 

24-31 Controller/device status (see Section 2.15.3) 



2.15.3 Channel Status and Controller/Device Status for Extended I/O Devices 





Bit 


Description 




CHANNEL STATUS 


16 


Echo 






17 


Post program controlled interrupt 






18 


Incorrect length 






19 


Channel program check 






20 


Channel data check 






21 


Channel control check 




« 


22 


Interface check 






23 


Chaining check 




CONTROLLER/ 


24 


Busy 




DEVICE STATUS 


25 


Status modified 






26 


Controller end 






27 


Attention 






28 


Channel end 






29 


Device end 






.30 


Unit check 






31 


Unit exception . 
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WORD 4 
Bits 0-31 



WORD 5 
Bits 0-7 
Bits 8-31 

WORD 6 
BitO 
Bitl 
Bit 2 
Bit 3 
Bit 4 
Bits 5-7 
Bits 8-31 



WORD 7 
Bit 0-7 

Bits 8-15 



Record Length - This field is used by IOCS to indicate the actual 
number of bytes transferred during read/ write operations. 

With execute channel requests and an error occurs this word will 
contain the residual transfer count from the request. 



Reserved. 

I/O Queue Address - This field is set by IOCS to point to the I/O 
queue for an I/O request initiated from this FCB. 



No wait normal end afction not taken 

No wait error end action not taken 

"Kill" command, I/O not issued 

If set, exceptional condition has occurred in the I/O request 

If set, software read flow control required. 

Reserved. 

Wait I/O Error Return Address - This field is set by the user and 
contains the address to which control is to be transferred in the 
case of an unrecoverable error when control bits 1 and 3 of word 2 
are reset. If this field is not initialized and an unrecoverable error 
is detected under the above conditions, the user is aborted. 



Index to FPT - This field points to the nth FPT in the File Pointer 
Table (FPT). 

FAT Address - This field points to the File Assignment Table (FAT) 
entry associated with all I/O performed on behalf of this FCB. 
This field is supplied by IOCS. 



Note: Words 8-15 are valid only if Bit 6 of Word 2 is set. 
WORD 8 

Bits 0-7 Reserved. 

Bits 8-31 



Expanded Data Address - Start address of data area for read or 
write operations. Must be a word address. 

(or) 

Expanded Data/Command Chain Address - Word address that points 
to the data or commmand chain list if using execute channel entry 
point (KIOCS,10). 
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WORD 9 
Bits 0-31 



Expanded Quantity - Number of bytes of data to be transferred. 

(or) 

For GPMC devices which support data/command chaining: 
Expanded Number of Data/Command Chain Doublewords. If 
data/command chaining is desired (execute channel KIOCS,10), 
this is used to indicate the number of data/command chain 
doublewords in the list. 



WORD 10 
Bits 0-31 



WORD 11 
Bits 0-31 



WORD 12 
Bits 0-31 



Expanded Random Access Address - This field contains a block 
number (zero origin) relative to the beginning of the disc file. It is 
the start address for the current read or write operation. 

(or) , 

For High Speed Data (HSD) Interface requests in non-Execute 
Channel Program format, this word defines a device command. 



Status Word 1 - For extended I/O, these are the 32 bits returned by 

1.1 r»r-k.icr" ___— __^^ 

mti DCINOd UUIIIIIIGIIIU. 

(or) 

For communications adapter interface, external asynchronous 
interrupt (EAI) status if Bit 12 of Word 2 is set. 



Status Word 2 - Second status word as returned from the Extended 
I/O hardware. 

(or) 

For High Speed Data (HSD) Interface applications, this word 
contains status sent from the user's device. 



WORD 13 
Bits 0-7 
Bits 8-31 



Reserved. 

No-Wait I/O normal completion service address return. This user 
service must be terminated by calling H.IOCS,34 (no-wait I/O end 
action return). 

(or) 
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For High Speed Data (HSD) Interface applications, this address plus 
1 word is the location to which control is transferred on 
asynchronous notification. 



WORD 14 

Bits 0-7 Reserved. 

Bits 8-31 No-Wait I/O error completion service address return. This user 

service must be terminated by calling H.IOCS,34 (no-wait I/O end 
action return). 

WORD 15 

Bits 0-7 Number of 192W buffers if specifying large blocking buffers. A 

value of one or zero in this field specifies one blocking buffer. 

Bits 8-31 Blocking Buffer Address - Defined for device independent I/O or a 

Post Programmed Controlled Interrupt End Action Receiver for 
device dependent I/O. 
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2.16 File Pointer Table (FPT) 

The File Pointer Table (FPT) provides the linkage between the File Control Block (FCB) 
and the File Assignment Table (FAT). It also allows for multiple logical file code 
assignments to be equivalenced to the same FAT. The linkage to the FAT is performed 
at assignment. The linkage to the FCB is performed at opening. The FPT resides m the 
task's service area. 

FPT entries 1-6 are reserved for the system as follows: 

Entry 1 - System LFC *s* 

Entry 2 - Load module LFC *LM 

Entry 3 - H.VOMM resource descriptor LFC (1) 

Entry 4 - H.VOMM directory LFC (2) 

Entry 5 - H.VOMM DMAP/SMAP LFC (3) 

Entry 6 - H.VOMM modify resource descriptor LFC X'FFFEE' 

Each FPT entry has the following format: 



Word 

1 



Reserved 



Flags 
(FPT.FLGS) 
See Note 1 



Reserved 



7 8 



31 



Logical file code (FPT.LFC) 



FCB address (FPT.FCBA) 



FAT address (FPT.FATA) 



Notes 

1. Bits in FPT.FLGS are assigned as follows 



Reserved 

If set, multiple FPT entries exist which point to the same FAT (Le., $ASSIGN4 

or $ASSIGN Ifc TO LFC=lfc statements) 

Reserved 

If set, FPT open 

If set, this FPT entry is not in use 

If set, pseudo SYC assignment (used by TSM) 

If set, pseudo FPT for unassigned temporary file 

Reserved 
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2.17 I/O Queue (lOQ) Entry 

The I/O Queue (lOQ) Entry is dynamically allocated fronn memory pool and contains 
information required to queue and process an I/O request. These entries are variable in 
length and support multiple device commands which are built starting at the end of the 
standard lOQ entry. The I/O queue consists of one or more I/O Queue Entries linked to 
either a Controller Definition Table (CDT) or a Unit Definition Table (UDT). 



Word 



7 8 



15 16 



23 24 



31 



String forv/ard address (lOQ.Sh A) 



String backward address (lOQ.SBA; 



Queue priority 
(lOQ.PRI) 



Reserved (lOQ.RTN) 



I/O type 
(IOQ.TYPE) 



Channel number 
(IOQ.CHNO) 



Subaddress 
(IOQ.5UBA) 



PSDl of task interrupt routine (lOQ.PSD) See Note 1 



PSD2 of task interrupt routine 



Status 
(IOQ.5TAT) 
See Note 2 



FCB or TCPB address 
(IOQ.FCBA) 



Program 

number 

(lOQ.PRGN) 



CDT address 
(IOQ.CDTA) 



8 
9 

10 

^ 11, 

^ 12 

13 
14 

15_ 



Handler function word 1 (lOQ.FCTl) 



Handler function word 2 (IOQ.FCT2) See Note 3 



Handler function word 3 (IOQ.FCT3) See Note 4 



Handler function word 4 (IOQ.FCT4) 



32-Bit flag word (lOQ.FLGS) See Note 3 



FAT address (lOQ.FATA) 



Number of bytes transferred 
(IOQ.UTRN) See Note 6 



Number of words in OS buffer 
(IOQ.WOSB) See Note 6 



OS buffer address (lOQ.FBUF) 



16 
17 

T n 

19 

21 
22 

23 



User's buffer address (lOQ.TBUF) 



I/O returned status word 1 (lOQ.I^ST) 



I/O returned status word 2 (IOQ.I5T1) See Note / 



1/9 returned status word 3 (IOQ.IST2) Sjse Note t 



UDT address (lOQ.UDTA) 



Control information from word 2 of FCB (lOQ.CONT) 



Address of context block (lOQ.CBLK) or 
Device context area address (lOQ.DCAA) 



Mode bits 
(extended I/O) 
(IOQ.MODE) 
See Note 9 or 
Word address of 
set mode bits 
(lOQ.MOWD) 



Queue priority 
temporary storage 
(IOQ.PSAV) 



Number of extra words in th 
queue entry (lOQ.XTRA) 



IS 



24 
25 



Device inop buffer address (for I/O error processing) (lOQ.INOP) 



Address of first word of dynamic lOCD list (extended I/0)(IOQ.IOCD) See Note 10 
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Notes 

1. For no-waiL I/O this field is set to point to the I/O post processing routine 
(S.IOCSl). When I/O completes, control will be passed to this service. 

2. Bits in lOQ.STAT are assigned as follows. 

If set, I/O queue is active (Note: Reset by device handler when physical I/O 
transfer completes.) 

1 If set, sense command was issued on behalf of this I/O request (extended I/O) 

2 If set, error retry was issued (rezero and retry entire lOCD list) (extended I/O) 

3 If set, operator intervention required; do not restart I/O 

4 Reserved 

5 If set, read ECC was issued (extended I/O) 

6 If set, error retry was issued (retry entire lOCD list) (extended I/O); 
backspace write or read sequence performed for extended I/O tape 

7 Reserved 

3. For extended I/O devices, IOQ.FCT2 contains the 24-bit virtual address of the data 
(or)IOCL. (Bits 0-7=0) 

4. For extended I/O devices, IOQ.FCT3 contains the adjusted byte transfer count in 
bits 0-31 (maximum is C.ADMA5K+1). 

5. Bits in lOQ.FLGS are assigned as follows. 

If set, multiplexed controller 

1 If set, OPCOM console request 

2 If set, TCW has been absolutized 

,^_3-« -If set^lQCiLwiilJaa^Unked tjj the UDT not the CDT 

4 If set, deallocate OS buffer 

5 If set, extended I/O 

6 If set, error found 
If set, system console queue 

8 If set, data move required (OS to user buffer) 

9 If set, rewind command in lOCD list for magnetic tape or Reserve command 
in lOCD list for disc (extended I/O) 

LU If set, nonexecute channel read command (extended I/O) 
[1 t If set, nonexecute channel write command (extended I/O) 

12 If set, special handler post processing required (Handler EP6) 

13 H.CTOO has been called with an FCB, not with a TCPB (i.e., not via 
H.IOCS,14) 

L4 Reserved 

If set, terminal input 

If set, terminal output 

If set, task swappable during I/O 

If set, release command in lOCD list for disc (extended I/O) 

No-wait I/O (not T5M) 

If set, I/O restart entry 

If set, nondevice access I/O performed 

Kill command issued for this I/O request 

If set, execute channel program (extended I/O) 

If set, user privileged 
23 D-class controller (GPMC) only 

26 Physical I/O performed on behalf of a user requesting blocked I/O 
27-28 Reserved 

29 If set, EOF testing required for disc 
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30 If set, movement in file is in negative direction 

31 If set, continuous EOF search (disc and floppy disc only) 

6. For extended I/O devices, lOQ.UTRN is a full word (Bits 0-31) and lOQ.WOSB is not 
applicable. 

7. For extended I/O devices, lOQ.ISTl is initialized to the start address within the I/O 
queue for any dynamic lOCD's. 

8. For extended I/O devices, IOQ.IST2 is initialized to the stop address within the I/O 
queue for any dynamic lOCD's. 

9. Mode bits are peculiar to each device. 

10. This cell contains the absolute data (or) lOCL address associated with the I/O 
request. 
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239 Unit Definition Table (UDT) 

The Unit Definition Table (UDT) is\a system resident structure used to identify device 
dependent information required by \ handier for a specific device. The UDT ^s built by 
the SYSGEN process, one for each \ievice configured m the system. During SYSGEN, 
each UDT is linked to its corresponding Controller Definition Table CCDT) and 
consequently its associated controller) and handler. 



.^ 



^' 



O 



Word 



7 8 



4 



r\ 



y 



UDT index^(UDT.UDTI) -) 



Unit status 
(UDT.STAT) 

See Note 1 ., 
% 



J I 



Reserved 



Physical 
channel 
number 
(UDT.PCHN) 



P / 4 N 



15 16 



23 24 



^ 



/y 



Device type 
code (UDT.DTC) 
See Note 2 



CDT index (UDT.CDTI) 
Logical' PLogical sub- 

channel >, ^ 

number H ^TyTC 
CUDT.CHAN) 



address (UDT.SUBA) 

c 



'-? 



Address of Dispatch Queue entry of 

task which has device allocated if device is not shared 

fUDT.DQEA) 



12-te / 



Physical sub- 
address 
(UDT.PSUB) 



lO 



Flags 
(UDT.FLGS)^ 
See Note 5 




Sectors per 
block V 

(UDT.SPB)^r 

Number 
characters 
per line 
^J)J.CHAR) 
See Note 3 



Sectors per allocation 
unit (UDT.SPAU) 



or 



Number lines per 
screen (UDT.LINE) 
See Note 4 



Number of sectors 
per track on 
disc or global 
line counter if a 
terminal (UDT.SPT) 



Maximum byte transfer 
(UDT.MBX) 



Numb er of sectors oh disc or tab setting if a terminal (U DT.SECSj^ ^ __^_ — ^_^_ 

r. _^__ _: i:,:;r«« « Number of heaos on uisu Or a tau seuuing 



Sector size, on disc or a 
tab setting if a terminal 

(UDT.SSIZ) 

■Serial-Qumber if tape or removable disc (UDT.SEKN) 
Perip^ieral time out value (UDT.PTOV) 
Address pf dev 



Number of heaos on uisu or a tau seuuing 
^ if a terminal (UDT.NHDS) 



Reserved 



or Handler name 



at initialization 



Bit flags See Note 5 (UDT.BIT2) 



ice context area tUbH-;i^|-Aaior l- 

n (UDT.HNAM ^ ' Vf^ \ T - -, 

' ~' Associated, Allocated Resource Table 



I 



index if assigned (UDT.ARTI) 



Service interrupt handler address ^pJ.SIH A) 
Device historical data address CUDi^^HiS^^j 



Address of first IQQ linked>te-this device jUDT.HUUj 
Address of last lOQ linked to this device (UDT.BIOQ) 



Link Priority 
(UDT.LPRl) 



Link Count 
(UDT.IOCT) 



Unit Status byte 2 (UUl .5 1 AZ; bee Note ; 



f) 



/ 

y 



Q 



t^J> ^ 
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Notes 

1. Bits in UDT.STAT are assigned as follows. 

If set, on-line (UDT.ONLI) 

1 If set, dual ported XIO disc (UDT.DPDC) 

2 If set, allocated (UDT.ALOC) 

3 If set, in use (UDT.USE) 

4 If set, system output unable to allocate (UDT.NOAL) 

5 If ^t, shared device (UDT.SHR) 

6 If set, premounted (UDT.PREM) 

7 If set, terminal (TSM) device (UDT.TSM) 

2. For example, 01 for any disc; 04 for any tape, etc. Valid device type codes are 
listed in Appendix A of the MPX-32 reference manual 

3. For discs, contains number of sectors per block (UDT.SPB). For terminals, contains 
number of characters per line (UDT.CHAR). 

4. For discs, contains number of sectors per allocation unit (UDT.SPAU). For 
terminals, contains number of lines per screen (UDT.LINE). 

5. Bits in UDT.FLGS are assigned as follows. 

If set, extended I/O device (UDT.FCLS) 

1 If set, I/O outstanding (UDT.IOUT) 

2 If set, removable disc pack (UDT.RMDV) 

_ _ ,3 - , , If set, terminal user logged on (UDT.LOGO) 

4 If set, autoselectable for batch SLO (UDT.BSLO) 

5 If set, autoselectable for batch SBO (UDT.BSBO) 

6 If set, autoselectable for real-time SLO (UDT.RSLO) 

7 If set, autoselectable for real-time SBO (UDT.RSBO) 

6. Bits in UDT.BIT2 are assigned as follows. 

u II set, purt 15 pnvauej eiae awituneu ^wi^ i .ui/-m_^ 

1 If set, port is connected to modem (UDT.MODM) 

2 If set^ port has graphic capability (UDT.GRFC) 
3. If set, port is full duplex (UDT.FDUX) 

4 If set, port is configured multidrop (UDT.MDRA) 

5 If set, volume mounted on device (UDT.VOL) 

6 If set, echo by computer (UDT.ECHO) 

7 Device has failed. Log off TSM (UDT.DEAD) 
"T^ If set, cache device (UDT.CAC) 

9 If set, inhibit automatic line wrap (UDT.NRAP) 

K) Reserved 

11 If set, quarter inch cartridge tape drive (UDT.QITD) 

' IZ If set, software read flow control required (UDT.RXON) 

13 If set, software write flow control required (UDT.WXON) 

14 If set, hardware read flow control required (UDT.RHWF) 

15 If set, hardware write flow control required (UDT.WHWF) 

7. Bits in UDT.STA2 are assigned as follows, 

If set, lOQ linked from UDT (UDT.IOQ) 

1 If set, lOP device (initialized by SYSGEN) (UDT.IOP) 

2 If set, device malfunction (UDT.MALF) 

3 If set, operator intervention applicable (UDT.INTV) 

4 If set, use standard XIO interface 
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Table 5-6 
Device Functions (Terminals, Handler Acticsn Only) 



Operation 


IOCS 

Op 

Code 




Handler = KASMP 
(ALIM) 


Handler = F8XIO 
(8-Line) 


Open 
M.FILE 


NOP 


Initialize lOP 
Channel if Necessary 


Rewind 
M.RWND 


1 


NOP 


SENSE Operation 


Read Rec. 
M.READ 


2 


Read to Data 
Buffer 


Read to Data 
Buffer 


Write Rec. 
M.WRIT 


3 


Write Record to 
Terminal 


Write Record to 
Terminal 


Write EOF 
M.WEOF 


4 


NOP 


NOP 


Execute 
Channel 


5 


Execute Channel 


Execute Channel 


Advance 

Record 

M.FWRD 


6 


Connect Communi- 
cations Channel 


Set Data Terminal 
Ready 


Advance 

File 

M.FWRD 


7 


Disconnect Com- 
munications 
Channel 


Reset Data 
Terminal Ready 


Backspace 

Record 

IvtBACK 


8 


Initialize Dev- 
ice and Set 
Timeout Value 


Used by J.TINIT to 
Initialize Terminals 


Backspace 
File M.BACK 


9 


Clear Break 
Status Flag Word 


Reset Request to 
Send 


Upspace 
M.L)PSP 


A 


Spec Error 


Set Request to Send 


Erase/Punch 
Trailer 


B 


Transmit Break 


Set/Reset Break 
(depends on flags 
in FOB) 


Eject/Punch 

Leader 

M.EJECT 


C 


Spec Error 


Define Special 
Character 


Close 
M.CLSE 


D 


NOP 


NOP 


Reserve FHD 
Port 


E 


Spec Error 


Set Single Channel 
Operation (Default) 


Release FHD 
Port 


F 


Spec Error 


Set Dual Channel Ope 



NOP = No operation performed 



Spec Error = Illegal operation code 
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Trible 5-8 
Default and Special Device Formatting (Page 2 df 2) 



73 
n> 

CA 

o 

c 
<-t 
o 

0) 

> 

w 
0) 2. 

D. D 

c:3 
o 3 






Device 


(Bit 2=0) 


(Bit 2=1) 


Bite 




Bit 9 


Bit 10 


Bit 11 


Bit 12 


Mag Tape 


Binary, ODD 


See Bits 8-10 ^ 


0=lnterchange 


If Bit 8=0: 


0=800 bpi 






(MT, 7- 


parity, 800 bpi 




(binary coded 




0=EVEN parity 


1=556 bpi 






track only) 






decimal) 




l=ODD parity 














l=Packed (binary) 










(MT 9- 


N/A 
















track only) 


















Discs 


Report EOF if 


No EOF reporting 














; (DM,DF,FL) 


X'OFEOFEOF' en- 
countered in word 
of 1st block 
during read of un- 
blocked record 


on unblocked reads 














ALIM 


Read: receive 


Bit 2 1 


3it 8 Bit 9 




On Read: 






(Asynch- 


data (bytes) 


Read 


1 


=Blind mode reset 


1= Inhibit 






ronous 


defined for 





1 


=Echo on read 


conversion of 






Line 


transfer count 


1 


N/A N/A 


=Receive data 


lower case 






Interface 










=Receive data 


characters to 






Module) 


Write: formatted 








upper case 






' Terminals 




Write 


N/A 


=Formatted v/rite 


0= Convert 






(TY) 







N/A 1 


^Initialize device 












1 


N/A N/A 


sUnformatted w/rite 








8-Line 


Read: perform 


Read: if format- 


Transmit 




Read: 


Read (if 


Read: 


Read: 


Asynchronous 


special character 


matting is 


break 




0=Echo 


Bit 2=0): 


0=no special 


0=do not purge 


dommunications 


formatting. 


inhibited, reads 


(erase, 




by con- 


O=convert lower 


character 


type ahead 


Multiplexer 




n bytes. 


punch) 




troller 


case character 


detect 


buffer 


(TY) 


Write: first 




(trailer); 




l=No echo 


to upper case 


l=special 


l=purge type 




character is for 




0=Stop 




by con- 


l=Inhibit 


character 


ahead buffer 




form control. 


Write n bytea 
v>/ith form 
control. 


trans- 
mitting 
break 
l=5tart 
trans- 
mitting 
break. 
Read: 
1=ASCII 
control 
character 




troller 

Write: 

0=Normal 

w/rite 

l=InitiBlize 

device (load 

UART 

parameters) 


conversion 


detect 

Write 

O=normal write 
l=write with 
input subchannel 
monitoring plus 
software flow 
control 










detect 
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Table 5-9 Standard Terminal and Line Printer 

Carriage Control Characters and 

Interpretation 

Result 



Control 
Character 


Hex 
Value 


Result on a 
Terminal 


Result on a 
Line Printer 


Blank 


20 


One linefeed/carriage 
return before write. 


Single space 
before print. 





30 


Two linefeed/carriage 
returns before write. 


Double space 
before print. 


1 


31 


Five linefeed/no 
carriage returns 
before write. 


Page eject (slew) 
before print. 


+ 


2B 


No linefeed/carriage 
return before write 
(line append). 


No space before 
print (overprint). 




2D 


Five linefeed/carriage 
returns before write. 


Page eject, save and 
print up to three user 
supplied title lines. 
See Note 1 
See Note 2 


< 


3C 


One linefeed/carriage 
return before write. 


Set inhibit spooler 
title line in this file. 
See Note 2 


> 


3E 


One linefeed/carriage 
return before write. 


Set enable spooler 
title line in this file. 
See Note 2 




3D 


One linefeed/carriage 
return before write. 


Page eject and clear 
up to three user 
supplied title lines 
in this file. 
See Note 2 



Notes: 
1. 



User supplied title lines have the same effect as this character. Supplying a 
fourth title line clears the first three, but only one page is ejected. User 
supplied titles are retained by the spooler and are repeated at the top of each 
page until cleared or the spool file ends. 

2. If the line printer is directly allocated this character is processed as a blank and 
the spooler title line is not produced. 
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8.2.105 M.MEMB - Get Memory in Byte Increments 7^ yUATCA ^:^ V M T^'t^^^^^"^ 

The M.MEMB service allows the task to ciynaiT^.icaliy expand its memory allocation in ^-^ -^^ 

doubleword increments starting at the end of its DSECT up to the top of its logical 

address space. The additional memory will be of the same type specified when the tasK 

was cataloged. The task will be mapped in a iogicaily contiguous manner up to the end of 

its address space. The task will be suspended until the allocation is successful. Repeated 

calls to this service are allowed. Allocation will not be contiguous with previously 

allocated space. 

This service cannot be used in conjunction with the M.GE or M.GD services.' 
The base mode equivalent service is M_GETMEMBYTES. 
Entry Conditions 
Calling Sequence: 

M.MEMB num 

(or) 



LW 
SVC 

where: 

num 

Exit Conditions 



R4,=num (or) LI R^jnum 

2,X'4B' (or) M.CALL H.REMM,28 



is the number of bytes to allocate 



Return Sequence: 

M.RTRN R3,R4 
Registers: 



CC1=0 
CC2=0 

R3 



Rif 

(or) 

CC1=0 
CC2=i 

R3 
R^ 



contains the 2^-bit starting logical doubleword address of allocated 
. space 

contains the number of bytes actually allocated (modulo 2W) 



contains the 2^-bit starting logical doubleword address of allocated 
space 

contains the number of bytes actually allocated (modulo 2W). 
However, the number is less than requested. 
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Error Conditions 

Allocation Denied: 

CC1 = 1 
CC2=1 

R3=0 
R^=0 
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S.2.106 M.MEMFRE - Free Memory in Byte Increments 

y^^ ^. V^EMFRE service allows the task to dynamically deallocate acquired memory. 
DeallocaL can be random. The space address must have ^^^l^.^^^^^^^^^^ ^^°- 

the M.MEMB service. All of the space obtained from a given call is deallocated. 

This service cannot be used in conjunction with the M.FE or M.FD services. 

The base mode equivalent service is M_FREE ME MBYTES. 

Entry Conditions 

Calling Sequence: 

M.MEMFRE addr 

(or) 

LW R3,addr 

SVC 2,X'«fC' (or) M.CALL H.REMM,29 

where: 

addr is the starting address of a previously acquired dynamic space from 

the M.MEMB service 

Exit Conditions 
Return Sequence: 

M.RTRN R3 (or) abort user with RIV177 

Registers: 

R3.0 if deallocation could not be performed. Deallocation address was not 

found in allocation table. 

Abort Cases: 

RM77 A task has destroyed the allocation linkages in this dynamic expansion 

space. 
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8.2.130 M.RE AD - Read Record 

The M.READ service performs the following functions: 

Provides soecial random access handling for disc files..^. 

Deblocks system files and blocked files. 

Reads one record into the buffer indicated by the Transfer f^Mnro! 'A'ord (TCV) in 

The base mode equivalent service is M READ, 
Entry Conditions 
Calling Sequence: 

M.READ fcb 

(or) 

LA l,fcb 

SVC l,X'3i' (or) M.CALL H.IOCS,3 

where: 

^^^ is the FCB address. Appropriate transfer control parameters are 

defined in the TCW (see Section 7.9.1.2). 

Exit Conditions 
Return Sequence: 

M.RTRN 
Registers: 

•None 
Abort Cases: 

TO03 Nnnprivilpf^ed user nttomptinp trnn'.fpr tn n lnp;irnl nddrpn-i n\\W\(\r 

legal boundaries. 
IO06 Invalid blocking buffer control cell for a system or blocked file. 

I026 Read attempted for a system or blocked file while write in process. 

IO30 Illegal volume record. Either volume number or reel ID from volume 

record do not match FAT information. 
I032 Second attempt to read a $ statement in a SYC file. 

Output Messages: 

DISMOUNT/MOUNT messages if EOT and multivolume magnetic tape 



MPX-32 

Volume I System Services 8-199 



8-2.13 i M_READ - Read Record 

The M_READ s«-vice performs the following functions: 

Provides special random access handling for disc files. 

Deblocks system files and blocked files. 

Reads one record into the buffer indicated bv the Transfer Control Word (TCyHf) in 
the FCB. 

The nonbase mode equivalent service is M.READ. 

Entry Conditions 

Calling Sequence: 

M__RPAn[rrnAnnR]a(ifir 

(or) 

SVC 1,X'31' (or) M.CALL H.IOCS,3 

where: 

addr is the FCB address. Appropriate transfer control parameters are 

defined in the TCW (see Section 7.9.1.2). 

Registers: 

R 1 contains addr 



Return Sequence: 
M.RTRN 

Registers: 
None 

Abort Cases: 



IO03 

IO06 
I026 
IO30 

1032 



Nonprivileged user attempting transfer to a logical address outside 

legal boundaries. 

Invalid blocking buffer control cell for a system or blocked file. 

Read attempted for a system or blocked file while write in process. 

Illegal volume record. Either volume number or reel ID from volume 

record do not match FAT information. 

Second attempt to read a $ statement in a SYC file. 



Output Messages: 

DISMOUNT/MOUNT messages if EOT and multivolume magnetic tape 
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8-2.178 M.WRIT - Write Record 

Tlie M.WRIT service pcrlorms the iollowing functions: 

Prevents a write to a read-only file. 

Provides special random access handling for disc files. 

Blocks records for system and blocked files. 

Writes volume record if BOT on multivolume magnetic tape. 

Performs ERASE/WRITE EOF if EOT on multivolume magnetic tape. 

Writes one record from the buffer pointed to by the TCW in the FCB. 
The base mode equivalent service is M_WRITE. 
Entry Conditions 



Calling Sequence: 




M.WRIT 


fcb 


(or) 




LA 
SVC 


l,fcb 

1,X'32' (or) M.CALL H.I0CS,4 


where: 




fcb 


is the FCB address 


Exit Conditions 





Return Sequence: 
M.RTRN 

Registers: 
None 

Abort Cases: 

IO06 
IO09 
I027 
I03S 



Invalid blocking buffer control cell for a system or a blocked file. 
Illegal operation on the SYC file 

Write attempted while reading from a system or a blocked file. 
Write attempted on a file opened in read only mode. 



OutDut Messages: 

niSMOUNT/MOUNT messages if EOT on multivolume magnetic tape 



8-260 



System Services 



MPX-32 
Volume I 



Apr 



-t2 138296 



P. 02/03 



32 



TO-^? 



GOULD C.S.D. MPX-32 3-2C 



M.'XSYSO: PA3£ 



* 
T4S< 



M.EXIT 

SVC 

5NDM 

CATAD 



TIM5 OATftW 

LD:.123 DATAW 

>"L3C_734 DATAW 

■^S3? 04rAS 



1/X'55 



DCAL VA^IAiLES 



Z' CXITIN3 F^DM ^AIN PR'DsRAM ..*' 



t 



DOFD 

:i64 



:i6D 



< 



B A 1 1 It n 
P v/ W ^ U 

MSGSrCW G5NI ' 
* 

*** laooo.si INT, 

STr 
DAI 
I'M 

~;^><.wRiT 

LA 
SVG 



*-MS32 




SI.:^T 
SAVcRfGS 



LW 

STW 

UW 

LF 

lpsdcm 

Q A T a w 



I w 



1 2/M5G2CMT-r23/3(*iSG2) 



^O/SAVERSSS 
X'OA' 

ri/msgit:w 

^IrUTTCW 
JTFCS 

JTFC3/i03D4 
1#rUT = C3 

l/X'32' 

1/Sl.CNT . 
^1/L0C^128 

^i/x"i2a' 
"1rt7loc_75^ - 

=?1/X'7B4' 
?D/SAVSft=GS 

OLD. PSD 

D 

3f^ 



V^ 



SAVE REGlSTr^S 

DISPLAY 'liSSAQ^ TT ySS^ TQ LiT 
fflEM <NDfl' THAT HIS HANDLER IS 
3 = IN3 cX::'JT£D. 



^^^^ C3NTSNT5 OF /ASH3LZ LDC Ml 

5T0S= IT " """ 

3ET CDNTiMTS 0^ ^ARIABLS LOC 734 
STORS IT 

=?ETURM ID POINT 3= I ^J T = R =? Jo T I DN 



7 ^ 

K. 



\\oao 



lo 



M$.31 



DATA3 



I.N iNTci^RUPT iANDLSR 



Apr 17,86 15:42 138296 



P . 3 / 3 



c 



000D05 



TOMP 



GOULD C.S.:3. -^PX-SZ 3,2C 



M=JX?Y3a3 PAI-r 



^>^ 



» --- a^MD 

* ...- 

DATAW 
OaTAW 
A T a w 
0AT4W 
OATAW 
IDCB.TA'^ OATAW 



i 



30U^0 

EQU 



•( i 'J »! * « 






/ 






1>— 

12/MSG1C^T/£D/3(^S31); 



n 
s 

X'OSDOOODI' 
X'0Q07€010' 
X'OODODDDQ' 

x'OQaoooaD' 

:'T£ST' 
10 

s 

32/0/32/D 

52/0 
32/0 

32/0 

3'UT ' 
1 A 
6W 



iNP'UT/OUrPUT CONTROL 2L0:< 
3JTPUT 1 WORD QP DAT^ 
iTAftTIN3 AT LOCATDN K'TSDIQ' 



DJTPUT DATA 



lMTE!?RU?r G0NT5XT $LDC< 



'1L5 :o;grROL 3lo:^ 



0073. 


0071. 


0072. 


0073. 


0074. 


0075* 


D075. 


0077. 


007S. 


0079. 


0050* 


00S1, 


0082. 


0083, 


0084* 


0035. 


0035. 


003?. 


0035* 


0039. 


0090» 


0O91. 


>• j^ rt -s 



0O93. 



ND 



HSD.aSG 



009 



